home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.4 Applications 1997 August / SGI IRIX 6.4 Applications 1997 August.iso / dist / mmailp.idb / usr / lib / Zmail / keymap.hlp.z / keymap.hlp
Encoding:
Text File  |  1997-01-22  |  7.3 KB  |  167 lines
  1. Motif uses a number of special symbolic key names that are not equivalent
  2. across all X installations.  Z-Mail includes extensive information to map
  3. these keysyms to several combinations of X11 with various keyboards, but
  4. still occasionally fails to interpret keys correctly.  Symptoms you may see
  5. include:
  6.  
  7.     Backspace fails to erase characters in text entry fields.
  8.     Backspace deletes characters to the right of the cursor.
  9.     Page up, page down, home, end, or arrow keys do not work.
  10.     Extended characters on non-English keyboards are ignored.
  11.  
  12. If you are having trouble with Motif key bindings, here are some suggestions
  13. that may be helpful.
  14.  
  15. International Keyboards (extended characters):
  16. ----------------------------------------------
  17.  
  18. Many extended character set keyboards (i.e. those for languages other than
  19. U.S. English) use the left Meta key to allow entry of ASCII symbols that
  20. are overloaded on the keyboard.  Motif, however, does not distinguish the
  21. left and right Meta keys -- either one will invoke a menu accelerator,
  22. rather than entering the intended ASCII symbol.
  23.  
  24. To avoid this problem, it is necessary to use the xmodmap command to remove
  25. the "meta" meaning from the left Meta key, so Motif will differentiate it:
  26.  
  27.     xmodmap -e 'remove Mod1 = Meta_L Mode_switch' \
  28.         -e 'keysym Mode_switch = NoSymbol' \
  29.         -e 'keysym Meta_L = Mode_switch' \
  30.         -e 'add Mod2 = Mode_switch'
  31.  
  32. DECstation keyboards:
  33. ---------------------
  34.  
  35. The "backspace" key on a DECstation keyboard is frequently mapped to the
  36. Delete symbol.  The Backspace symbol usually does not have a mapping,
  37. though it occasionally is mapped on F12.  The simplest workaround for this
  38. is to use the xmodmap command:
  39.  
  40.     xmodmap -e "keysym Delete = Delete osfBackSpace"
  41.  
  42. This leaves the backspace key mapped to Delete (so DECterm and other DEC
  43. X apps continue to work correctly) and adds the osfBackSpace mapping to
  44. that key for use by Motif apps like Z-Mail.  Note that this is different
  45. from the usual symbolic mapping for osfBackSpace (below).
  46.  
  47. Sun keyboards and OpenWindows:
  48. ------------------------------
  49.  
  50. If you are running the Motif version of Z-Mail under OpenWindows, many of
  51. the labeled keys on the Sun keyboard may act differently than expected or
  52. may not work at all.  Fortunately, the Motif window manager (mwm) looks for
  53. a file in the user's home directory, named ".motifbind".  This file may be
  54. used to specify new bindings for the Motif key symbols.  The following is
  55. a sample set of symbol bindings for the Sun type 4 keyboard.
  56.  
  57. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  58. !"X11/NeWS - Sun Microsystems Inc."
  59. ! OpenWindows 2.0 Server for a Sun-4
  60. ! with a type 4 keyboard
  61. ! Place this in ~/.motifbind
  62.  
  63. osfCancel       :               <Key>Escape
  64. osfLeft         :               <Key>Left
  65. osfUp           :               <Key>Up
  66. osfRight        :               <Key>Right
  67. osfDown         :               <Key>Down
  68. osfEndLine      :               <Key>End
  69. osfBeginLine    :               <Key>Home
  70. osfPageUp       :               <Key>Prior
  71. osfPageDown     :               <Key>Next
  72. osfBackSpace    :               <Key>BackSpace
  73. osfDelete       :               <Key>Delete
  74. osfInsert       :               <Key>Insert
  75. osfAddMode      :Shift          <Key>F8
  76. osfHelp         :               <Key>Help
  77. osfMenu         :               <Key>F4
  78. osfMenuBar      :               <Key>F10
  79. osfCut          :               <Key>F20
  80. osfPaste        :               <Key>F18
  81. osfCopy         :               <Key>F16
  82. osfUndo         :               <Key>F14
  83. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  84.  
  85. Sun keyboards and the MIT X Server
  86. ----------------------------------
  87.  
  88. If you are running the Motif version of Z-Mail on a Sun under the standard
  89. X server, you may wish to use the following as your .motifbind file.
  90.  
  91. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  92. !"X11R4 or X11R5"
  93. ! MIT X Server for a Sun-4
  94. ! with a type 4 keyboard
  95. ! Place this in ~/.motifbind
  96. osfCancel       :               <Key>Escape
  97. osfLeft         :               <Key>Left
  98. osfUp           :               <Key>Up
  99. osfRight        :               <Key>Right
  100. osfDown         :               <Key>Down
  101. osfEndLine      :               <Key>End
  102. osfBeginLine    :               <Key>Home
  103. osfPageUp       :               <Key>Next
  104. osfPageDown     :               <Key>Prior
  105. osfBackSpace    :               <Key>BackSpace
  106. osfDelete       :               <Key>Delete
  107. osfInsert       :               <Key>Insert
  108. osfAddMode      :Shift          <Key>F8
  109. osfHelp         :               <Key>Help
  110. osfMenu         :Shift          <Key>F10
  111. osfMenuBar      :               <Key>F10
  112. osfCopy         :               <Key>F15
  113. osfCut          :               <Key>F18
  114. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  115.  
  116. HP Keyboards and X servers
  117. --------------------------
  118. The fallback virtual binding table that HP provided to OSF for connection of
  119. Motif clients to HP servers has some defects.  The HP-specific keysyms should
  120. have had an "hp" prefix (i.e., "hpInsertChar"), as can be seen correctly in
  121. the X11R5 XKeysymDB file.
  122.  
  123. The XKeysymDB file is an X Consortium registry, and is correct.  Users should
  124. not attempt to change this file.  Instead, one should use a ".motifbind" file
  125. in their home directory which provides the corrected table, or use the
  126. "xmbind" utility (available only with X11R5/Motif 1.2) to edit the virtual
  127. key table in the MOTIF_BINDINGS property on the root window.
  128.  
  129. If All Else Fails:
  130. ------------------
  131.  
  132. If you are not running mwm, you are unable to supply a .motifbind for
  133. every user, or key binding problems persist, you may wish to modify your
  134. system.zmailrc file to add key bindings when Z-Mail starts up.  The
  135. following sample maps the most common X11 key bindings into corresponding
  136. Motif key bindings.  However, not all X servers and keyboards have all of
  137. these bindings.  Attempting to modify an undefined key symbol with xmodmap
  138. will produce a lengthy error message.  You may wish to edit the list below
  139. to omit some cases.  Note that there are two alternatives for each of
  140. osfHelp, osfPageDown, and osfPageUp.  You should select one of those
  141. alternatives; do not attempt to use both.
  142.  
  143. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  144. if is_gui
  145.     # If we do all these keysyms in one xmodmap, and any of the
  146.     # keys on the left of the = are not defined, the whole thing
  147.     # will fail.  Do them one by one instead.
  148.     sh 'xmodmap -e "keysym BackSpace = BackSpace osfBackSpace"'
  149.     sh 'xmodmap -e "keysym Delete = Delete osfDelete"'
  150.     sh 'xmodmap -e "keysym Down = Down osfDown"'
  151.     sh 'xmodmap -e "keysym End = End osfEndLine"'
  152.     sh 'xmodmap -e "keysym Escape = Escape osfCancel"'
  153. #   sh 'xmodmap -e "keysym F1 = F1 Help osfHelp"'
  154.     sh 'xmodmap -e "keysym Help = Help osfHelp"'
  155.     sh 'xmodmap -e "keysym Home = Home osfBeginLine"'
  156.     sh 'xmodmap -e "keysym Insert = Insert osfInsert"'
  157.     sh 'xmodmap -e "keysym Left = Left osfLeft"'
  158.     sh 'xmodmap -e "keysym PageDown = PageDown Next osfPageDown"'
  159. #   sh 'xmodmap -e "keysym Next = Next PageDown osfPageDown"'
  160.     sh 'xmodmap -e "keysym PageUp = PageUp Prior osfPageUp"'
  161. #   sh 'xmodmap -e "keysym Prior = Prior PageUp osfPageUp"'
  162.     sh 'xmodmap -e "keysym Right = Right osfRight"'
  163.     sh 'xmodmap -e "keysym Up = Up osfUp"'
  164. endif
  165. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  166.  
  167.